Backlink Opportunity Finder v2

Discover broken backlink opportunities from Google SERPs, crawl ranking pages, classify broken links with confidence, enrich with contact data, and export outreach-ready files.

What It Does

Keywords -> Google SERP -> Prioritized crawl queue -> Link checks -> Contact extraction -> Merged v2 opportunities -> Dataset + exports

1. Searches Google with SERP proxies and optional competitor query expansion.
2. Prioritizes likely resource pages using URL/title/snippet signals.
3. Crawls pages with proxy-aware HTTP requests, per-domain politeness, and adaptive concurrency.
4. Skips low-value pages such as non-HTML, oversized, tiny, login/app, non-English, or no-outbound-link pages.
5. Checks external dofollow links with a run-level status cache.
6. Classifies broken links as confirmed_404, confirmed_410, soft_404, blocked_unknown, timeout_unknown, or error_unknown.
7. Scores, merges, filters, and exports v2 opportunities.

Input Example

{
    "keywords": ["best seo tools 2025", "link building strategies guide"],
    "resultsPerKeyword": 10,
    "competitorDomains": ["ahrefs.com", "semrush.com"],
    "replacementUrl": "https://example.com/seo-tools",
    "minOpportunityScore": 40,
    "includeNoContactResults": true,
    "maxRunMinutes": 10,
    "exportFormat": "v2-detailed"
}

Only keywords is required.

Important Inputs

Field	Default	Description
resultsPerKeyword	10	Google results per search query.
competitorDomains	[]	Expands SERP queries and records competitor mentions.
replacementUrl	""	Adds deterministic pitch angle text.
domainAllowlist	[]	Only crawl matching domains or subdomains.
minOpportunityScore	0	Suppress weak opportunities.
includeNoContactResults	true	Include opportunities without email/social/contact page.
maxConcurrency	10	Maximum URL crawl workers; runtime adapts within this cap.
maxRunMinutes	4	Run-level time budget.
maxHtmlBytes	2000000	Skip oversized HTML responses.
skipNonHtml	true	Skip non-HTML content types.
skipNonEnglish	false	Skip pages that fail a lightweight English heuristic.
enableSoft404Detection	true	Detect not-found pages that return HTTP 200.
exportFormat	v2-detailed	Primary export label; all export files are written.

Output

The default dataset contains v2 opportunity rows plus one run-summary row. Each opportunity includes:

• opportunityId, schemaVersion, matchedKeywords
• sourcePage with canonical URL
• brokenLinks with status, confidence, anchor text, and text evidence
• contact details and contact confidence
• quality scores for relevance and contact quality
• competitorMatches
• replacementUrl and pitchAngle
• crawlDiagnostics

The actor also writes these key-value-store records:

• backlink-opportunity-finder_v2-detailed.json
• backlink-opportunity-finder_ahrefs-style.csv
• backlink-opportunity-finder_semrush-style.csv
• backlink-opportunity-finder_pitchbox.csv
• backlink-opportunity-finder_buzzstream.csv
• backlink-opportunity-finder_csv.csv
• backlink-opportunity-finder_summary.json

Scoring

Scores are 0-100 and combine:

• broken-link count
• confirmed/soft broken-link confidence
• contact quality
• keyword relevance to source page
• replacement/pitch usefulness

Named emails score higher than generic emails such as info@, support@, and hello@.

Notes

• Google SERP scraping uses Camoufox and Google SERP proxy.
• Source-page crawling uses got-scraping, proxy escalation, per-domain politeness, and adaptive concurrency.
• Screenshots, HTML evidence, AI-generated snippets, and cross-run resume are intentionally not included in this v2 implementation.